home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / winsock / wlprs40c.zip / WSOCKAID.ASC < prev    next >
Text File  |  1994-12-21  |  6KB  |  145 lines
  1.                    WSOCKAID.DLL Version 2.0b
  2.                                
  3.                        December 21, 1994
  4.                                
  5. This DLL contains functions that are currently missing in the
  6. Windows Sockets 1.1 specification, but which are needed for
  7. some networking applications. Currently this DLL supports only
  8. FTP Software's PC/TCP Version 2.1 and above. For this TCP/IP
  9. stack, all information that WSOCKAID.DLL can give is retrieved
  10. from the PCTCP.INI file (or whatever your PCTCP env. variable
  11. points to). If you want to use this DLL together with other
  12. stacks and get errors like "Could not resolve username" from
  13. network applications, look at the list of functions below. For
  14. each inquiry function the information returned to a program can
  15. also be defined in the WIN.INI file by creating a section named
  16. [WSOCKAID] and adding the appropriate entry.
  17.  
  18. For setting the username a Control Panel Applet named
  19. WSAIDCNF.CPL is included. If you move this program to your
  20. WINDOWS/SYSTEM directory, you can set the username by double-
  21. clicking on the "question mark face" icon. See also the remarks
  22. on the WSAIDGetUsername function below.
  23.  
  24. The following functions are exported by this DLL:
  25.  
  26. WSAIDGetUsername   This function retrieves the user name that
  27.                    a PC user has registered with the
  28.                    networking software. If the used networking
  29.                    software has a real Windows network driver
  30.                    (like PC/TCP 2.2 and later has) and this
  31.                    driver supports the WNetGetUser function,
  32.                    the return value of this function is given
  33.                    to the calling program instead of the
  34.                    username defined in the [WSOCKAID] section
  35.                    of WIN.INI. You can override this behaviour
  36.                    to always use the username in the
  37.                    [WSOCKAID] section by putting an entry like
  38.  
  39.                           AlwaysUseWSAIDUsername=1
  40.  
  41.                    into this section, or checking the
  42.                    corresponding box in the Control Panel
  43.                    applet.
  44.                    To find out if your networking software has
  45.                    such a driver, look if the [boot] section
  46.                    in SYSTEM.INI contains a network.drv= entry
  47.                    that is not empty.
  48.                    If such a driver cannot be located, the DLL
  49.                    looks at various places to obtain a
  50.                    username. These places are (in search order
  51.                    ):
  52.                    
  53.                        the öUser=ö entry of section [pctcp general] if the PCTCP
  54.                        env. variable is set to an existing configuration file for FTP
  55.                        SoftwareÆs PC/TCP
  56.                        the öUsername=ö entry of section [Network] in SYSTEM.INI
  57.     the öUsername=ö entry of section [TcpGlobal] in
  58. TCPUTILS.INI
  59.                        the öUser=ö entry of section [WSockAid] in WIN.INI
  60.  
  61.                    [WSOCKAID]-Entry:  User=<username>
  62.  
  63. WSAIDGetRealname   This function returns the real name that a
  64.                    PC user has registered with the networking
  65.                    software.
  66.                    
  67.                    [WSOCKAID]-Entry:  Full-Name=<user's real
  68.                    name>
  69.  
  70. WSAIDGetHostname   This function returns the locally defined
  71.                    host name for the PC (without any domain
  72.                    information appended).
  73.                    
  74.                    The following places are searched for a
  75.                    hostname definition in the given order:
  76.                    
  77.                        the öHost-Name=ö entry of section [pctcp general] if the
  78.                        PCTCP env. variable is set to an existing configuration file
  79.                        for FTP SoftwareÆs PC/TCP
  80.                        the öComputerName=ö entry of section [Network] in
  81.                        SYSTEM.INI
  82.     the öHost-Name=ö entry of section [WSockAid] in WIN.INI
  83.  
  84.                    [WSOCKAID]-Entry:  Host-Name=<PC's
  85.                    hostname>
  86.  
  87. WSAIDGetDomain     This function returns the Internet domain
  88.                    that the PC belongs to.
  89.                    
  90.                    [WSOCKAID]-Entry:  Domain=<PC's domain>
  91.  
  92. WSAIDGetDefaultPrinter              This function returns the
  93.                    default LPR network printer as separate
  94.                    queue and server name.
  95.                    
  96.                    [WSOCKAID]-Entry:  LPRQueue=<queue name>
  97.                                    LPRServer=<server name>
  98.  
  99.  
  100. Change Log:
  101.  
  102. Version 2.0a:
  103.  
  104.    WSOCKAID now searches in various other places for a
  105.    username. The search order is:
  106.    1. See if a network driver is installed (see SYSTEM.INI
  107.        section [boot], entry network.drv=). If present, call
  108.        its function WNetGetUser().
  109.    2. Look if the env. variable PCTCP is defined. If so, try
  110.        to read the username from the relevant INI file.
  111.    3. Look if the SYSTEM.INI section [Network] contains an
  112.        entry Username=.
  113.    4. Look if a file TCPUTILS.INI exists which has an entry
  114.        Username= in the section [TCPGlobal]
  115.    5. Return an error value.
  116.  
  117. Version 2.0b:
  118.  
  119.    Removed a small bug that caused the username set in the
  120.    [WSockAid] section of WIN.INI not to be used although is
  121.    should have been.
  122.    Now the WSAIDGetHostname() function returns the
  123.    öComputerName=ö setting in the [Network] section of
  124.    SYSTEM.INI if this is defined (under Windows for
  125.    Workgroups).
  126.  
  127. Copyright:
  128.  
  129. This DLL is Copyright (C) 1993-94 by Thomas Heil.
  130. Redistribution of this DLL is allowed only together with the
  131. documentation (as PostScript file and as plain ASCII .ASC
  132. file). This software may not be sold by itself. Applications
  133. that use this DLL may be sold together with the DLL and its
  134. documentation included royalty free.
  135.  
  136. If you are a network software vendor and think that your TCP/IP
  137. stack should be supported, please contact me.
  138.  
  139. Author:
  140.  
  141. Thomas Heil
  142. Hindenburgstr. 50
  143. 41352 Korschenbroich
  144. E-Mail: th.heil@kfa-juelich.de (Internet)
  145.